home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / pmlogger.z / pmlogger
Encoding:
Text File  |  2001-04-17  |  31.8 KB  |  529 lines

  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmllllooooggggggggeeeerrrr - create archive log for performance metrics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      $$$$PPPPCCCCPPPP____BBBBIIIINNNNAAAADDDDMMMM____DDDDIIIIRRRR////ppppmmmmllllooooggggggggeeeerrrr [----cccc _c_o_n_f_i_g_f_i_l_e] [----hhhh _h_o_s_t] [----llll _l_o_g_f_i_l_e] [----LLLL] [----nnnn
  13.      _p_m_n_s_f_i_l_e] [----PPPP] [----rrrr] [----ssss _e_n_d_s_i_z_e] [----tttt _i_n_t_e_r_v_a_l] [----TTTT _e_n_d_t_i_m_e] [----vvvv _v_o_l_s_i_z_e]
  14.      [----VVVV _v_e_r_s_i_o_n] [----xxxx _f_d] _a_r_c_h_i_v_e
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      ppppmmmmllllooooggggggggeeeerrrr creates the archive logs of performance metric values that may
  18.      be ``played back'' by other Performance Co-Pilot (see PPPPCCCCPPPPIIIInnnnttttrrrroooo(1)) tools.
  19.      These logs form the basis of the VCR paradigm and retrospective
  20.      performance analysis services common to the PCP toolkit.
  21.  
  22.      The mandatory argument _a_r_c_h_i_v_e is the base name for the physical files
  23.      that constitute an archive log.
  24.  
  25.      The ----VVVV option specifies whether a version 1 or version 2 archive is
  26.      generated.  A version 2 archive also stores the associated Performance
  27.      Metrics Name Space (PMNS). By default a version 2 archive is generated.
  28.  
  29.      Unless directed to another host by the ----hhhh option, ppppmmmmllllooooggggggggeeeerrrr will contact
  30.      the Performance Metrics Collector Daemon (PMCD) on the local host and use
  31.      that as the source of the metric values to be logged.
  32.  
  33.      To support the required flexibility and control over what is logged and
  34.      when, ppppmmmmllllooooggggggggeeeerrrr maintains an independent two level logging state for each
  35.      instance of each performance metric.  At the first (mandatory) level,
  36.      logging is allowed to be oooonnnn (with an associated interval between
  37.      samples), or ooooffffffff or mmmmaaaayyyybbbbeeee.  In the latter case, the second (advisory)
  38.      level logging is allowed to be oooonnnn (with an associated interval between
  39.      samples), or ooooffffffff.
  40.  
  41.      The mandatory level allows universal specification that some metrics must
  42.      be logged, or must nnnnooootttt be logged.  The default state for all instances of
  43.      all metrics when ppppmmmmllllooooggggggggeeeerrrr starts is mandatory maybe and advisory off.
  44.  
  45.      Use ppppmmmmllllcccc(1) to interrogate and change the logging state once ppppmmmmllllooooggggggggeeeerrrr is
  46.      running.
  47.  
  48.      If a metric's state is mandatory (on or off) and a request is made to
  49.      change it to mandatory maybe, the new state is mandatory maybe and
  50.      advisory off.  If a metric's state is already advisory (on or off) and a
  51.      request is made to change it to mandatory maybe, the current state is
  52.      retained.
  53.  
  54.      It is not possible for ppppmmmmllllooooggggggggeeeerrrr to log specific instances of a metric and
  55.      all instances of the same metric concurrently.  If specific instances are
  56.      being logged and a request to log all instances is made, then all
  57.      instances of the metric will be logged according to the new request,
  58.      superseding any prior logging request for the metric.  A request to log
  59.      all instances of a metric will supersede any previous request to log all
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  71.  
  72.  
  73.  
  74.      instances.  A request to log specific instances of a metric when all
  75.      instances are already being logged is refused.  To do this one must turn
  76.      off logging for all instances of the metric first.  In each case, the
  77.      validity of the request is checked first; for example a request to change
  78.      a metric's logging state to advisory on when it is currently mandatory
  79.      off is never permitted (it is necessary to change the state to mandatory
  80.      maybe first).
  81.  
  82.      Optionally, each system running ppppmmmmccccdddd(1) may also be configured to run a
  83.      ``primary'' ppppmmmmllllooooggggggggeeeerrrr instance.  Like ppppmmmmccccdddd(1), this ppppmmmmllllooooggggggggeeeerrrr instance is
  84.      launched by $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp.  On Irix the launch is affected by the files
  85.      /_e_t_c/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r (use cccchhhhkkkkccccoooonnnnffffiiiigggg(1M) to activate or disable the
  86.      primary ppppmmmmllllooooggggggggeeeerrrr instance), /_e_t_c/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r._o_p_t_i_o_n_s (command line
  87.      options passed to the primary ppppmmmmllllooooggggggggeeeerrrr).
  88.      $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._d_e_f_a_u_l_t is the default initial
  89.      configuration file for the primary ppppmmmmllllooooggggggggeeeerrrr.
  90.  
  91.      The primary ppppmmmmllllooooggggggggeeeerrrr instance is identified by the ----PPPP option.  There may
  92.      be at most one ``primary'' ppppmmmmllllooooggggggggeeeerrrr instance on each system with an
  93.      active ppppmmmmccccdddd(1).  The primary ppppmmmmllllooooggggggggeeeerrrr instance (if any) must be running
  94.      on the same host as the ppppmmmmccccdddd(1) to which it connects, so the ----hhhh and ----PPPP
  95.      options are mutually exclusive.
  96.  
  97.      When launched as a non-primary instance, ppppmmmmllllooooggggggggeeeerrrr will exit immediately
  98.      if the configuration file causes no metric logging to be scheduled.  The
  99.      ----LLLL option overrides this behavior, and causes a non-primary ppppmmmmllllooooggggggggeeeerrrr
  100.      instance to ``linger'', presumably pending some future dynamic re-
  101.      configuration and state change via ppppmmmmllllcccc(1).  ppppmmmmllllooooggggggggeeeerrrr will also linger
  102.      without the ----LLLL option being used if all the metrics to be logged are
  103.      logged as once only metrics. When the once only metrics have been logged,
  104.      a warning message will be generated stating that the event queue is empty
  105.      and no more events will be scheduled.
  106.  
  107.      By default all diagnostics and errors from ppppmmmmllllooooggggggggeeeerrrr are written to the
  108.      file _p_m_l_o_g_g_e_r._l_o_g in the directory where ppppmmmmllllooooggggggggeeeerrrr is launched.  The ----llll
  109.      option may be used to override the default behavior.  If the log file
  110.      cannot be created or is not writable, output is written to standard error
  111.      instead.
  112.  
  113.      If specified, the ----ssss option instructs ppppmmmmllllooooggggggggeeeerrrr to terminate after a
  114.      certain size in records, bytes or time units has been accumulated. If
  115.      _e_n_d_s_i_z_e is an integer then _e_n_d_s_i_z_e records will be written to the log.
  116.      If _e_n_d_s_i_z_e is suffixed by bbbb or bbbbyyyytttteeeessss then _e_n_d_s_i_z_e bytes of the archive
  117.      data will be written out (note, however, that archive log record
  118.      boundaries will not be broken and so this limit may be slightly
  119.      surpassed).  Other viable file size units include:  KKKK, KKKKbbbb, KKKKiiiilllloooobbbbyyyytttteeee for
  120.      kilobytes and MMMM, MMMMbbbb, MMMMeeeeggggaaaabbbbyyyytttteeee for megabytes.  These units may be
  121.      optionally suffixed by an ssss and may be of mixed case.  Alternatively
  122.      _e_n_d_s_i_z_e may be suffixed using a time unit as described in PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for
  123.      the _i_n_t_e_r_v_a_l argument (to the standard PCP tool option ----tttt).
  124.      Some examples of different formats:
  125.           ----ssss 111100000000
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  137.  
  138.  
  139.  
  140.           ----ssss 111100000000bbbbyyyytttteeeessss
  141.           ----ssss 111100000000KKKK
  142.           ----ssss 111100000000MMMMbbbb
  143.           ----ssss 11110000mmmmiiiinnnnssss
  144.           ----ssss 11110000hhhhoooouuuurrrrssss
  145.      The default is for ppppmmmmllllooooggggggggeeeerrrr to run forever.
  146.  
  147.      The ----rrrr option causes the size of the physical record(s) for each group of
  148.      metrics and the expected contribution of the group to the size of the PCP
  149.      archive for one full day of collection to be reported in the log file.
  150.      This information is reported the first time each group is successfully
  151.      written to the archive.
  152.  
  153.      The log file is potentially a multi-volume data set, and the ----vvvv option
  154.      causes ppppmmmmllllooooggggggggeeeerrrr to start a new volume after a certain size in records,
  155.      bytes, or time units has been accumulated for the current volume.  The
  156.      format of this size specification is identical to that of the ----ssss option
  157.      (see above).  The default is for ppppmmmmllllooooggggggggeeeerrrr to create a single volume log.
  158.      Additional volume switches can also be forced asynchronously by either
  159.      using ppppmmmmllllcccc(1) or sending ppppmmmmllllooooggggggggeeeerrrr a SIGHUP signal (see below). Note, if a
  160.      scheduled volume switch is in operation due to the ----vvvv option, then its
  161.      counters will be reset after an asynchronous switch.
  162.  
  163.      Normally ppppmmmmllllooooggggggggeeeerrrr operates on the distributed Performance Metrics Name
  164.      Space (PMNS), however if the ----nnnn option is specified an alternative local
  165.      PMNS is loaded from the file _p_m_n_s_f_i_l_e.
  166.  
  167.      Under normal circumstances, ppppmmmmllllooooggggggggeeeerrrr will run forever (except for a ----ssss
  168.      option or a termination signal).  The ----TTTT option may be used to limit the
  169.      execution time using the format of time as prescribed by PPPPCCCCPPPPIIIInnnnttttrrrroooo(1).
  170.      Some examples of different formats:
  171.           ----TTTT 11110000mmmmiiiinnnnssss
  172.           ----TTTT ''''@@@@ 11111111::::33330000''''
  173.      From this it can be seen that ----TTTT 11110000mmmmiiiinnnnssss and ----ssss 11110000mmmmiiiinnnnssss perform identical
  174.      actions.
  175.  
  176.      When ppppmmmmllllooooggggggggeeeerrrr receives a SIGHUP signal, the current volume of the log is
  177.      closed, and a new volume is opened.  This mechanism (or the alternative
  178.      mechanism via ppppmmmmllllcccc(1)) may be used to manage the growth of the log files
  179.      - once a log volume is closed, that file may be archived without ill-
  180.      effect on the continued operation of ppppmmmmllllooooggggggggeeeerrrr.  See also the ----vvvv option
  181.      above.
  182.  
  183.      The buffers for the current log may be flushed to disk using the fffflllluuuusssshhhh
  184.      command of ppppmmmmllllcccc(1), or by sending ppppmmmmllllooooggggggggeeeerrrr a SIGUSR1 signal.  This is
  185.      useful when the log needs to be read while ppppmmmmllllooooggggggggeeeerrrr is still running.
  186.  
  187.      When launched with the ----xxxx option, pmlogger will accept asynchronous
  188.      control requests on the file descriptor _f_d.  This option is only expected
  189.      to be used internally by PCP applications that support ``live record
  190.      mode'' via ppppmmmmRRRReeeeccccoooorrrrddddCCCCoooonnnnttttrrrroooollll(3).
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  203.  
  204.  
  205.  
  206. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX
  207.      The configuration file may be specified with the ----cccc option.  If it is
  208.      not, configuration specifications are read from standard input.
  209.  
  210.      If _c_o_n_f_i_g_f_i_l_e does not exist, then a search is made in the directory
  211.      $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r for a file of the same name, and if found
  212.      that file is used, e.g. if _c_o_n_f_i_g._m_u_m_b_l_e does not exist in the current
  213.      directory and the file $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._m_u_m_b_l_e does
  214.      exist, then ----cccc ccccoooonnnnffffiiiigggg....mmmmuuuummmmbbbblllleeee and ----cccc
  215.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....mmmmuuuummmmbbbblllleeee are equivalent.
  216.  
  217.      The syntax for the configuration file is as follows.
  218.  
  219.      1.   Words are separated by white space (space, tab or newline).
  220.  
  221.      2.   The symbol ``#'' (hash) introduces a comment, and all text up to the
  222.           next newline is ignored.
  223.  
  224.      3.   Keywords (shown in bbbboooolllldddd below) must appear literally (i.e. in lower
  225.           case).
  226.  
  227.      4.   Each specification begins with the optional keyword lllloooogggg, followed by
  228.           one of the states mmmmaaaannnnddddaaaattttoooorrrryyyy oooonnnn, mmmmaaaannnnddddaaaattttoooorrrryyyy ooooffffffff, mmmmaaaannnnddddaaaattttoooorrrryyyy mmmmaaaayyyybbbbeeee,
  229.           aaaaddddvvvviiiissssoooorrrryyyy oooonnnn or aaaaddddvvvviiiissssoooorrrryyyy ooooffffffff.
  230.  
  231.      5.   For the oooonnnn states, a logging interval must follow using the syntax
  232.           ``oooonnnncccceeee'', or ``ddddeeeeffffaaaauuuulllltttt'', or ``eeeevvvveeeerrrryyyy _N _t_i_m_e_u_n_i_t_s'', or simply ``_N
  233.           _t_i_m_e_u_n_i_t_s'' - _N is an unsigned integer, and _t_i_m_e_u_n_i_t_s is one of the
  234.           keywords mmmmsssseeeecccc, mmmmiiiilllllllliiiisssseeeeccccoooonnnndddd, sssseeeecccc, sssseeeeccccoooonnnndddd, mmmmiiiinnnn, mmmmiiiinnnnuuuutttteeee, hhhhoooouuuurrrr or the
  235.           plural form of one of the above.
  236.  
  237.           Internal limitations require the interval to be smaller than
  238.           (approximately) 74 hours.  An interval value of zero is a synonym
  239.           for oooonnnncccceeee.  An interval of ddddeeeeffffaaaauuuulllltttt means to use the default logging
  240.           interval of 60 seconds; this default value may be changed to
  241.           _i_n_t_e_r_v_a_l with the ----tttt command line option.
  242.  
  243.           The _i_n_t_e_r_v_a_l argument follows the syntax described in PPPPCCCCPPPPIIIInnnnttttrrrroooo(1),
  244.           and in the simplest form may be an unsigned integer (the implied
  245.           units in this case are seconds).
  246.  
  247.      6.   Following the state and possible interval specifications comes a
  248.           ``{'', followed by a list of one or more metric specifications and a
  249.           closing ``}''.  The list is white space (or comma) separated.  If
  250.           there is only one metric specification in the list, the braces are
  251.           optional.
  252.  
  253.      7.   A metric specification consists of a metric name optionally followed
  254.           by a set of instance names.  The metric name follows the standard
  255.           PCP naming conventions, see ppppmmmmnnnnssss(4), and if the metric name is a
  256.           non-leaf node in the PMNS (see ppppmmmmnnnnssss(4)), then ppppmmmmllllooooggggggggeeeerrrr will
  257.           recursively descend the PMNS and apply the logging specification to
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  269.  
  270.  
  271.  
  272.           all descendent metric names that are leaf nodes in the PMNS.  The
  273.           set of instance names is a ``['', followed by a list of one or more
  274.           space (or comma) separated names, numbers or strings, and a closing
  275.           ``]''.  Elements in the list that are numbers are assumed to be
  276.           internal instance identifiers, other elements are assumed to be
  277.           external instance identifiers - see ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm(3) for more
  278.           information.
  279.  
  280.           If no instances are given, then the logging specification is applied
  281.           to all instances of the associated metric.
  282.  
  283.      8.   There may be an arbitrary number of logging specifications.
  284.  
  285.      9.   Following all of the logging specifications, there may be an
  286.           optional access control section, introduced by the literal token
  287.           [[[[aaaacccccccceeeessssssss]]]].  Thereafter come access control rules of the form ``aaaalllllllloooowwww
  288.           _h_o_s_t_l_i_s_t :::: _o_p_e_r_a_t_i_o_n ;;;;'' and ``ddddiiiissssaaaalllllllloooowwww _h_o_s_t_l_i_s_t :::: _o_p_e_r_a_t_i_o_n ;;;;''.
  289.  
  290.           The base _o_p_e_r_a_t_i_o_n_s are aaaaddddvvvviiiissssoooorrrryyyy, mmmmaaaannnnddddaaaattttoooorrrryyyy and eeeennnnqqqquuuuiiiirrrreeee.  In all
  291.           other aspects, these access control statements follow the syntactic
  292.           and semantic rules defined for the access control mechanisms used by
  293.           PMCD and are fully documented in ppppmmmmccccdddd(1).
  294.  
  295. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  296.      For each PCP utility, there is a sample ppppmmmmllllooooggggggggeeeerrrr configuration file that
  297.      could be used to create an archive log suitable for replaying with that
  298.      tool (i.e. includes all of the performance metrics used by the tool).
  299.      For a tool named _f_o_o this configuration file is located in
  300.      $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._f_o_o.
  301.  
  302.      The following is a simple default configuration file for a primary
  303.      ppppmmmmllllooooggggggggeeeerrrr instance, and demonstrates most of the capabilities of the
  304.      configuration specification language.
  305.  
  306.           log mandatory on once { hinv.ncpu hinv.ndisk }
  307.           log mandatory on every 10 minutes {
  308.               disk.all.write
  309.               disk.all.read
  310.               network.interface.in.packets [ "et0" ]
  311.               network.interface.out.packets [ "et0" ]
  312.               nfs.server.reqs [ "lookup" "getattr" "read" "write" ]
  313.           }
  314.  
  315.           log advisory on every 30 minutes {
  316.               environ.temp
  317.               pmcd.pdu_in.total
  318.               pmcd.pdu_out.total
  319.           }
  320.  
  321.           [access]
  322.           disallow * : all except enquire;
  323.           allow localhost : mandatory, advisory;
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  335.  
  336.  
  337.  
  338. AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC RRRREEEESSSSTTTTAAAARRRRTTTT
  339.      It is often useful for ppppmmmmllllooooggggggggeeeerrrr processes (other than the primary
  340.      instance) to be started and stopped when the local host is booted or
  341.      shutdown.  The script $_P_C_P__R_C__D_I_R/_p_c_p_l_o_c_a_l and the necessary soft-links
  342.      are provided, and can be modified by rrrrooooooootttt to run PCP tools automatically.
  343.      If you want to find out more before starting, read the manual pages for
  344.      rrrrcccc2222(1), rrrrcccc0000(1), sssshhhhuuuuttttddddoooowwwwnnnn(1) and the file /_e_t_c/_i_n_i_t._d/_R_E_A_D_M_E.
  345.  
  346.      For example, changing $_P_C_P__R_C__D_I_R/_p_c_p_l_o_c_a_l so that it contains:
  347.  
  348.          # Add startup actions here
  349.          ($PCP_BINADM_DIR/pmlogger_check &)
  350.          ;;
  351.  
  352.          # Add shutdown actions here
  353.          killall -INT pmlogger
  354.          ;;
  355.  
  356.      will start ppppmmmmllllooooggggggggeeeerrrr instances at boot time and terminate them in an
  357.      orderly fashion at system shutdown.
  358.  
  359.      This script runs as rrrrooooooootttt, so any _p_m_l_o_g_g_e_r instances it launches are also
  360.      run as rrrrooooooootttt.  To run some ppppmmmmllllooooggggggggeeeerrrr instances as a particular user, create
  361.      your own archive logger control file (see ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1)) and use the
  362.      ssssuuuu(1) command. e.g.
  363.  
  364.          # Add startup actions here
  365.          (su tanya -c "$PCP_BINADM_DIR/pmlogger_check -c /usr/people/tanya/ctl" &)
  366.          ;;
  367.  
  368.      at boot time will start the ppppmmmmllllooooggggggggeeeerrrr instances described in
  369.      /_u_s_r/_p_e_o_p_l_e/_t_a_n_y_a/_c_t_l, running as user ttttaaaannnnyyyyaaaa.
  370.  
  371. FFFFIIIILLLLEEEESSSS
  372.      _a_r_c_h_i_v_e....mmmmeeeettttaaaa        metadata (metric descriptions, instance domains,
  373.                          etc.) for the archive log
  374.      _a_r_c_h_i_v_e....0000           initial volume of metrics values (subsequent volumes
  375.                          have suffixes 1111, 2222, ...)
  376.      _a_r_c_h_i_v_e....iiiinnnnddddeeeexxxx       temporal index to support rapid random access to the
  377.                          other files in the archive log
  378.      $$$$PPPPCCCCPPPP____TTTTMMMMPPPP____DDDDIIIIRRRR////ppppmmmmllllooooggggggggeeeerrrr
  379.                          ppppmmmmllllooooggggggggeeeerrrr maintains the files in this directory as the
  380.                          map between the process id of the ppppmmmmllllooooggggggggeeeerrrr instance
  381.                          and the IPC port that may be used to control each
  382.                          ppppmmmmllllooooggggggggeeeerrrr instance (as used by ppppmmmmllllcccc(1))
  383.      ////eeeettttcccc////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr
  384.                          cccchhhhkkkkccccoooonnnnffffiiiigggg(1M) control flag, to control launching of
  385.                          ppppmmmmllllooooggggggggeeeerrrr from $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp
  386.      ////eeeettttcccc////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr....ooooppppttttiiiioooonnnnssss
  387.                          command line options to ppppmmmmllllooooggggggggeeeerrrr when launched from
  388.                          $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  401.  
  402.  
  403.  
  404.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....ddddeeeeffffaaaauuuulllltttt
  405.                          default configuration file for the primary logger
  406.                          instance launched from $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp
  407.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....*
  408.                          assorted configuration files suitable for creating
  409.                          logs that may be subsequently replayed with the PCP
  410.                          visualization and monitoring tools
  411.      $$$$PPPPCCCCPPPP____LLLLOOOOGGGG____DDDDIIIIRRRR////_h_o_s_t_n_a_m_e
  412.                          Default directory for PCP archive files for
  413.                          performance metric values collected from the host
  414.                          _h_o_s_t_n_a_m_e.
  415.      ./_p_m_l_o_g_g_e_r._l_o_g      (or $$$${{{{PPPPCCCCPPPP____LLLLOOOOGGGGDDDDIIIIRRRR----$$$$PPPPCCCCPPPP____LLLLOOOOGGGG____DDDDIIIIRRRR}}}}////_h_o_s_t_n_a_m_e////ppppmmmmllllooooggggggggeeeerrrr....lllloooogggg
  416.                          when started automatically by either $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp
  417.                          or one of the ppppmmmmllllooooggggggggeeeerrrr(1) monitoring scripts such as
  418.                          ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1))
  419.                          all messages and diagnostics are directed here
  420.      $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccppppllllooooccccaaaallll
  421.                          contains ``hooks'' to enable automatic restart at
  422.                          system boot time
  423.  
  424. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  425.      Normally ppppmmmmllllooooggggggggeeeerrrr creates a socket to receive control messages from
  426.      ppppmmmmllllcccc(1) on the first available TCP/IP port numbered 4330 or higher.  The
  427.      environment variable PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR____PPPPOOOORRRRTTTT may be used to specify an alternative
  428.      starting port number.
  429.  
  430. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  431.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  432.      file and directory names used by PCP.  On each installation, the file
  433.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  434.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  435.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  436.  
  437. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  438.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmllllcccc(1), ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1),
  439.      ppppccccpppp....ccccoooonnnnffff(4), ppppccccpppp....eeeennnnvvvv(4) and ppppmmmmnnnnssss(4).
  440.  
  441.      If you have the PCP product, relevant information is also available from
  442.      the on-line PCP Tutorial.  Provided the ppppccccpppp....mmmmaaaannnn....ttttuuuuttttoooorrrriiiiaaaallll subsystem from
  443.      the PCP images has been installed, access the URL
  444.      ffffiiiilllleeee::::$$$$PPPPCCCCPPPP____DDDDOOOOCCCC____DDDDIIIIRRRR////TTTTuuuuttttoooorrrriiiiaaaallll////aaaarrrrcccchhhhiiiivvvveeee....hhhhttttmmmmllll from your web browser.
  445.  
  446. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  447.      The archive logs are sufficiently precious that ppppmmmmllllooooggggggggeeeerrrr will not
  448.      truncate an existing physical file.  A message of the form
  449.       __pmLogNewFile: "foo.index" already exists, not over-written
  450.       __pmLogCreate: File exists
  451.      indicates this situation has arisen.  You must explicitly remove the
  452.      files and launch ppppmmmmllllooooggggggggeeeerrrr again.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  467.  
  468.  
  469.  
  470.      There may be at most one primary ppppmmmmllllooooggggggggeeeerrrr instance per monitored host;
  471.      attempting to bend this rule produces the error:
  472.       pmlogger: there is already a primary pmlogger running
  473.  
  474.      Various other messages relating to the creation and/or deletion of files
  475.      in $_P_C_P__T_M_P__D_I_R/_p_m_l_o_g_g_e_r suggest a permission problem on this directory,
  476.      or some feral files have appeared therein.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.